<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>Tie::Handle - base class definitions for tied handles - Perldoc Browser</title>
    <link rel="search" href="https://perldoc.perl.org/opensearch.xml" type="application/opensearchdescription+xml" title="Perldoc Browser">
    <link rel="canonical" href="https://perldoc.perl.org/Tie::Handle">
    <link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.5.2/css/bootstrap.min.css" integrity="sha384-JcKb8q3iqJ61gNV9KGb8thSsNjpSL0n8PARn9HuZOnIxN0hoP+VmmDGMN5t9UJ0Z" crossorigin="anonymous">
    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/stackoverflow-light.min.css" integrity="sha512-cG1IdFxqipi3gqLmksLtuk13C+hBa57a6zpWxMeoY3Q9O6ooFxq50DayCdm0QrDgZjMUn23z/0PMZlgft7Yp5Q==" crossorigin="anonymous" />
    <style>
      body {
        background: #f4f4f5;
        color: #020202;
      }
      .navbar-dark {
        background-image: -webkit-linear-gradient(top, #005f85 0, #002e49 100%);
        background-image: -o-linear-gradient(top, #005f85 0, #002e49 100%);
        background-image: linear-gradient(to bottom, #005f85 0, #002e49 100%);
        filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff005f85', endColorstr='#ff002e49', GradientType=0);
        background-repeat: repeat-x;
      }
      .navbar-dark .navbar-nav .nav-link,
      .navbar-dark .navbar-nav .nav-link:focus { color: #fff }
      .navbar-dark .navbar-nav .nav-link:hover { color: #ffef68 }
      #wrapperlicious {
        margin: 0 auto;
        font: 0.9em 'Helvetica Neue', Helvetica, sans-serif;
        font-weight: normal;
        line-height: 1.5em;
        margin: 0;
        padding: 0;
      }
      #wrapperlicious h1 { font-size: 1.5em }
      #wrapperlicious h2 { font-size: 1.3em }
      #wrapperlicious h3 { font-size: 1.1em }
      #wrapperlicious h4 { font-size: 0.9em }
      #wrapperlicious h1, #wrapperlicious h2, #wrapperlicious h3,
      #wrapperlicious h4, #wrapperlicious dt {
        color: #020202;
        margin-top: 1em;
        margin-bottom: 1em;
        position: relative;
        font-weight: bold;
      }
      #wrapperlicious a { color: inherit; text-decoration: underline }
      #wrapperlicious #toc { text-decoration: none }
      #wrapperlicious a:hover { color: #2a2a2a }
      #wrapperlicious a img { border: 0 }
      #wrapperlicious :not(pre) > code {
        color: inherit;
        background-color: rgba(0, 0, 0, 0.04);
        border-radius: 3px;
        font: 0.9em Consolas, Menlo, Monaco, monospace;
        padding: 0.3em;
      }
      #wrapperlicious dd {
        margin: 0;
        margin-left: 2em;
      }
      #wrapperlicious dt {
        color: #2a2a2a;
        font-weight: bold;
        margin-left: 0.9em;
      }
      #wrapperlicious p {
        margin-bottom: 1em;
        margin-top: 1em;
      }
      #wrapperlicious li > p {
        margin-bottom: 0;
        margin-top: 0;
      }
      #wrapperlicious pre {
        border: 1px solid #c1c1c1;
        border-radius: 3px;
        font: 100% Consolas, Menlo, Monaco, monospace;
        margin-bottom: 1em;
        margin-top: 1em;
      }
      #wrapperlicious pre > code {
        display: block;
        background-color: #f6f6f6;
        font: 0.9em Consolas, Menlo, Monaco, monospace;
        line-height: 1.5em;
        text-align: left;
        white-space: pre;
        padding: 1em;
      }
      #wrapperlicious dl, #wrapperlicious ol, #wrapperlicious ul {
        margin-bottom: 1em;
        margin-top: 1em;
      }
      #wrapperlicious ul {
        list-style-type: square;
      }
      #wrapperlicious ul ul {
        margin-bottom: 0px;
        margin-top: 0px;
      }
      #footer {
        font-size: 0.8em;
        padding-top: 0.5em;
        text-align: center;
      }
      #more {
        display: inline;
        font-size: 0.8em;
      }
      #perldocdiv {
        background-color: #fff;
        border: 1px solid #c1c1c1;
        border-bottom-left-radius: 5px;
        border-bottom-right-radius: 5px;
        margin-left: auto;
        margin-right: auto;
        padding: 3em;
        padding-top: 1em;
        max-width: 960px;
      }
      #moduleversion { float: right }
      #wrapperlicious .leading-notice {
        font-style: italic;
        padding-left: 1em;
        margin-top: 1em;
        margin-bottom: 1em;
      }
      #wrapperlicious .permalink {
        display: none;
        left: -0.75em;
        position: absolute;
        padding-right: 0.25em;
        text-decoration: none;
      }
      #wrapperlicious h1:hover .permalink, #wrapperlicious h2:hover .permalink,
      #wrapperlicious h3:hover .permalink, #wrapperlicious h4:hover .permalink,
      #wrapperlicious dt:hover .permalink {
        display: block;
      }
    </style>
    <!-- Global site tag (gtag.js) - Google Analytics -->
    <script async src="https://www.googletagmanager.com/gtag/js?id=G-KVNWBNT5FB"></script>
    <script>
      window.dataLayer = window.dataLayer || [];
      function gtag(){dataLayer.push(arguments);}
      gtag('js', new Date());

      gtag('config', 'G-KVNWBNT5FB');
      gtag('config', 'UA-50555-3');
    </script>
  </head>
  <body>
    <nav class="navbar navbar-expand-md navbar-dark bg-dark justify-content-between">
  <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarNav" aria-controls="navbarNav" aria-expanded="false" aria-label="Toggle navigation">
    <span class="navbar-toggler-icon"></span>
  </button>
  <a class="navbar-brand" href="https://perldoc.perl.org/">Perldoc Browser</a>
  <div class="collapse navbar-collapse" id="navbarNav">
    <ul class="navbar-nav mr-auto">
      <li class="nav-item dropdown text-nowrap">
        <a class="nav-link dropdown-toggle" href="./Tie::Handle.html#" id="dropdownlink-stable" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">5.35.0</a>
        <div class="dropdown-menu" aria-labelledby="dropdownlink-stable">
          <a class="dropdown-item" href="https://perldoc.perl.org/Tie::Handle">Latest</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.38.2/Tie::Handle">5.38.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.38.1/Tie::Handle">5.38.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.38.0/Tie::Handle">5.38.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.36.3/Tie::Handle">5.36.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.36.2/Tie::Handle">5.36.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.36.1/Tie::Handle">5.36.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.36.0/Tie::Handle">5.36.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.34.3/Tie::Handle">5.34.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.34.2/Tie::Handle">5.34.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.34.1/Tie::Handle">5.34.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.34.0/Tie::Handle">5.34.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.32.1/Tie::Handle">5.32.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.32.0/Tie::Handle">5.32.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.30.3/Tie::Handle">5.30.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.30.2/Tie::Handle">5.30.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.30.1/Tie::Handle">5.30.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.30.0/Tie::Handle">5.30.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.28.3/Tie::Handle">5.28.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.28.2/Tie::Handle">5.28.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.28.1/Tie::Handle">5.28.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.28.0/Tie::Handle">5.28.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.26.3/Tie::Handle">5.26.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.26.2/Tie::Handle">5.26.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.26.1/Tie::Handle">5.26.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.26.0/Tie::Handle">5.26.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.24.4/Tie::Handle">5.24.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.24.3/Tie::Handle">5.24.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.24.2/Tie::Handle">5.24.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.24.1/Tie::Handle">5.24.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.24.0/Tie::Handle">5.24.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.22.4/Tie::Handle">5.22.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.22.3/Tie::Handle">5.22.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.22.2/Tie::Handle">5.22.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.22.1/Tie::Handle">5.22.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.22.0/Tie::Handle">5.22.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.20.3/Tie::Handle">5.20.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.20.2/Tie::Handle">5.20.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.20.1/Tie::Handle">5.20.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.20.0/Tie::Handle">5.20.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.18.4/Tie::Handle">5.18.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.18.3/Tie::Handle">5.18.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.18.2/Tie::Handle">5.18.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.18.1/Tie::Handle">5.18.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.18.0/Tie::Handle">5.18.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.16.3/Tie::Handle">5.16.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.16.2/Tie::Handle">5.16.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.16.1/Tie::Handle">5.16.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.16.0/Tie::Handle">5.16.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.14.4/Tie::Handle">5.14.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.14.3/Tie::Handle">5.14.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.14.2/Tie::Handle">5.14.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.14.1/Tie::Handle">5.14.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.14.0/Tie::Handle">5.14.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.12.5/Tie::Handle">5.12.5</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.12.4/Tie::Handle">5.12.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.12.3/Tie::Handle">5.12.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.12.2/Tie::Handle">5.12.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.12.1/Tie::Handle">5.12.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.12.0/Tie::Handle">5.12.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.10.1/Tie::Handle">5.10.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.10.0/Tie::Handle">5.10.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.9/Tie::Handle">5.8.9</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.8/Tie::Handle">5.8.8</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.7/Tie::Handle">5.8.7</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.6/Tie::Handle">5.8.6</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.5/Tie::Handle">5.8.5</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.4/Tie::Handle">5.8.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.3/Tie::Handle">5.8.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.2/Tie::Handle">5.8.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.1/Tie::Handle">5.8.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.0/Tie::Handle">5.8.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.6.2/Tie::Handle">5.6.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.6.1/Tie::Handle">5.6.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.6.0/Tie::Handle">5.6.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.005_04/Tie::Handle">5.005_04</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.005_03/Tie::Handle">5.005_03</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.005_02/Tie::Handle">5.005_02</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.005_01/Tie::Handle">5.005_01</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.005/Tie::Handle">5.005</a>
        </div>
      </li>
      <li class="nav-item dropdown text-nowrap">
        <a class="nav-link dropdown-toggle" href="./Tie::Handle.html#" id="dropdownlink-dev" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">Dev</a>
        <div class="dropdown-menu" aria-labelledby="dropdownlink-dev">
          <a class="dropdown-item" href="https://perldoc.perl.org/blead/Tie::Handle">blead</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.39.6/Tie::Handle">5.39.6</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.39.5/Tie::Handle">5.39.5</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.39.4/Tie::Handle">5.39.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.39.3/Tie::Handle">5.39.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.39.2/Tie::Handle">5.39.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.39.1/Tie::Handle">5.39.1</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.38.0-RC2/Tie::Handle">5.38.0-RC2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.38.0-RC1/Tie::Handle">5.38.0-RC1</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.11/Tie::Handle">5.37.11</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.10/Tie::Handle">5.37.10</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.9/Tie::Handle">5.37.9</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.8/Tie::Handle">5.37.8</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.7/Tie::Handle">5.37.7</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.6/Tie::Handle">5.37.6</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.5/Tie::Handle">5.37.5</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.4/Tie::Handle">5.37.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.3/Tie::Handle">5.37.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.2/Tie::Handle">5.37.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.1/Tie::Handle">5.37.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.0/Tie::Handle">5.37.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.11/Tie::Handle">5.35.11</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.10/Tie::Handle">5.35.10</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.9/Tie::Handle">5.35.9</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.8/Tie::Handle">5.35.8</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.7/Tie::Handle">5.35.7</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.6/Tie::Handle">5.35.6</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.5/Tie::Handle">5.35.5</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.4/Tie::Handle">5.35.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.3/Tie::Handle">5.35.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.2/Tie::Handle">5.35.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.1/Tie::Handle">5.35.1</a>
          <a class="dropdown-item active" href="./Tie::Handle.html">5.35.0</a>
        </div>
      </li>
      <li class="nav-item dropdown text-nowrap">
        <a class="nav-link dropdown-toggle" href="./Tie::Handle.html#" id="dropdownlink-nav" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">Documentation</a>
        <div class="dropdown-menu" aria-labelledby="dropdownlink-nav">
          <a class="dropdown-item" href="perl.html">Perl</a>
          <a class="dropdown-item" href="perlintro.html">Intro</a>
          <a class="dropdown-item" href="perl.html#Tutorials">Tutorials</a>
          <a class="dropdown-item" href="perlfaq.html">FAQs</a>
          <a class="dropdown-item" href="perl.html#Reference-Manual">Reference</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="perlop.html">Operators</a>
          <a class="dropdown-item" href="functions.html">Functions</a>
          <a class="dropdown-item" href="variables.html">Variables</a>
          <a class="dropdown-item" href="modules.html">Modules</a>
          <a class="dropdown-item" href="perlutil.html">Utilities</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="perlcommunity.html">Community</a>
          <a class="dropdown-item" href="perlhist.html">History</a>
        </div>
      </li>
    </ul>
    <ul class="navbar-nav">
      <script>
        function set_expand (expand) {
          var perldocdiv = document.getElementById('perldocdiv');
          var width = window.getComputedStyle(perldocdiv).getPropertyValue('max-width');
          var expanded = (width == '' || width == 'none') ? true : false;
          if (expand === null) {
            expand = !expanded;
          }
          if ((expand && !expanded) || (!expand && expanded)) {
            perldocdiv.style.setProperty('max-width', expand ? 'none' : '960px');
            var button_classlist = document.getElementById('content-expand-button').classList;
            if (expand) {
              button_classlist.add('btn-light');
              button_classlist.remove('btn-outline-light');
            } else {
              button_classlist.add('btn-outline-light');
              button_classlist.remove('btn-light');
            }
          }
          return expand;
        }
        function toggle_expand () {
          var expand = set_expand(null);
          document.cookie = 'perldoc_expand=' + (expand ? 1 : 0) + '; path=/; expires=Tue, 19 Jan 2038 03:14:07 UTC';
        }
        function read_expand () {
          return document.cookie.split(';').some(function (item) { return item.indexOf('perldoc_expand=1') >= 0 });
        }
        if (document.readyState === 'loading') {
          document.addEventListener('DOMContentLoaded', function () {
            if (read_expand()) {
              set_expand(true);
            }
          });
        } else if (read_expand()) {
          set_expand(true);
        }
      </script>
      <button id="content-expand-button" type="button" class="btn btn-outline-light d-none d-lg-inline-block mr-2" onclick="toggle_expand()">Expand</button>
    <ul>
    <form class="form-inline" method="get" action="https://perldoc.perl.org/5.35.0/search">
      <input class="form-control mr-3" type="search" name="q" placeholder="Search" aria-label="Search">
    </form>
  </div>
</nav>

    <div id="wrapperlicious" class="container-fluid">
      <div id="perldocdiv">
        <div id="links">
          <a href="./Tie::Handle.html">Tie::Handle</a>
          <div id="more">
            (<a href="./Tie::Handle.txt">source</a>,
            <a href="https://metacpan.org/pod/Tie::Handle">CPAN</a>)
          </div>
            <div id="moduleversion">version 4.2</div>
        </div>
        <div class="leading-notice">
          You are viewing the version of this documentation from Perl 5.35.0.
            This is a development version of Perl.
        </div>
        <h1><a id="toc">CONTENTS</a></h1>
                  <ul>
              <li>
                <a class="text-decoration-none" href="./Tie::Handle.html#NAME">NAME</a>
              </li>
              <li>
                <a class="text-decoration-none" href="./Tie::Handle.html#SYNOPSIS">SYNOPSIS</a>
              </li>
              <li>
                <a class="text-decoration-none" href="./Tie::Handle.html#DESCRIPTION">DESCRIPTION</a>
              </li>
              <li>
                <a class="text-decoration-none" href="./Tie::Handle.html#MORE-INFORMATION">MORE INFORMATION</a>
              </li>
              <li>
                <a class="text-decoration-none" href="./Tie::Handle.html#COMPATIBILITY">COMPATIBILITY</a>
              </li>
          </ul>

      <h1 id="NAME"><a class="permalink" href="./Tie::Handle.html#NAME">#</a>NAME</h1>

<p>Tie::Handle - base class definitions for tied handles</p>

<h1 id="SYNOPSIS"><a class="permalink" href="./Tie::Handle.html#SYNOPSIS">#</a>SYNOPSIS</h1>

<pre><code>package NewHandle;
require Tie::Handle;

@ISA = qw(Tie::Handle);

sub READ { ... }		# Provide a needed method
sub TIEHANDLE { ... }	# Overrides inherited method


package main;

tie *FH, &#39;NewHandle&#39;;</code></pre>

<h1 id="DESCRIPTION"><a class="permalink" href="./Tie::Handle.html#DESCRIPTION">#</a>DESCRIPTION</h1>

<p>This module provides some skeletal methods for handle-tying classes. See <a href="perltie.html">perltie</a> for a list of the functions required in tying a handle to a package. The basic <b>Tie::Handle</b> package provides a <code>new</code> method, as well as methods <code>TIEHANDLE</code>, <code>PRINT</code>, <code>PRINTF</code> and <code>GETC</code>.</p>

<p>For developers wishing to write their own tied-handle classes, the methods are summarized below. The <a href="perltie.html">perltie</a> section not only documents these, but has sample code as well:</p>

<dl>

<dt id="TIEHANDLE-classname,-LIST"><a class="permalink" href="./Tie::Handle.html#TIEHANDLE-classname,-LIST">#</a><a id="TIEHANDLE"></a><a id="TIEHANDLE-classname-LIST"></a>TIEHANDLE classname, LIST</dt>
<dd>

<p>The method invoked by the command <code>tie *glob, classname</code>. Associates a new glob instance with the specified class. <code>LIST</code> would represent additional arguments (along the lines of <a href="AnyDBM_File.html">AnyDBM_File</a> and compatriots) needed to complete the association.</p>

</dd>
<dt id="WRITE-this,-scalar,-length,-offset"><a class="permalink" href="./Tie::Handle.html#WRITE-this,-scalar,-length,-offset">#</a><a id="WRITE"></a><a id="WRITE-this-scalar-length-offset"></a>WRITE this, scalar, length, offset</dt>
<dd>

<p>Write <i>length</i> bytes of data from <i>scalar</i> starting at <i>offset</i>.</p>

</dd>
<dt id="PRINT-this,-LIST"><a class="permalink" href="./Tie::Handle.html#PRINT-this,-LIST">#</a><a id="PRINT"></a><a id="PRINT-this-LIST"></a>PRINT this, LIST</dt>
<dd>

<p>Print the values in <i>LIST</i></p>

</dd>
<dt id="PRINTF-this,-format,-LIST"><a class="permalink" href="./Tie::Handle.html#PRINTF-this,-format,-LIST">#</a><a id="PRINTF"></a><a id="PRINTF-this-format-LIST"></a>PRINTF this, format, LIST</dt>
<dd>

<p>Print the values in <i>LIST</i> using <i>format</i></p>

</dd>
<dt id="READ-this,-scalar,-length,-offset"><a class="permalink" href="./Tie::Handle.html#READ-this,-scalar,-length,-offset">#</a><a id="READ"></a><a id="READ-this-scalar-length-offset"></a>READ this, scalar, length, offset</dt>
<dd>

<p>Read <i>length</i> bytes of data into <i>scalar</i> starting at <i>offset</i>.</p>

</dd>
<dt id="READLINE-this"><a class="permalink" href="./Tie::Handle.html#READLINE-this">#</a><a id="READLINE"></a>READLINE this</dt>
<dd>

<p>Read a single line</p>

</dd>
<dt id="GETC-this"><a class="permalink" href="./Tie::Handle.html#GETC-this">#</a><a id="GETC"></a>GETC this</dt>
<dd>

<p>Get a single character</p>

</dd>
<dt id="CLOSE-this"><a class="permalink" href="./Tie::Handle.html#CLOSE-this">#</a><a id="CLOSE"></a>CLOSE this</dt>
<dd>

<p>Close the handle</p>

</dd>
<dt id="OPEN-this,-filename"><a class="permalink" href="./Tie::Handle.html#OPEN-this,-filename">#</a><a id="OPEN"></a><a id="OPEN-this-filename"></a>OPEN this, filename</dt>
<dd>

<p>(Re-)open the handle</p>

</dd>
<dt id="BINMODE-this"><a class="permalink" href="./Tie::Handle.html#BINMODE-this">#</a><a id="BINMODE"></a>BINMODE this</dt>
<dd>

<p>Specify content is binary</p>

</dd>
<dt id="EOF-this"><a class="permalink" href="./Tie::Handle.html#EOF-this">#</a><a id="EOF"></a>EOF this</dt>
<dd>

<p>Test for end of file.</p>

</dd>
<dt id="TELL-this"><a class="permalink" href="./Tie::Handle.html#TELL-this">#</a><a id="TELL"></a>TELL this</dt>
<dd>

<p>Return position in the file.</p>

</dd>
<dt id="SEEK-this,-offset,-whence"><a class="permalink" href="./Tie::Handle.html#SEEK-this,-offset,-whence">#</a><a id="SEEK"></a><a id="SEEK-this-offset-whence"></a>SEEK this, offset, whence</dt>
<dd>

<p>Position the file.</p>

<p>Test for end of file.</p>

</dd>
<dt id="DESTROY-this"><a class="permalink" href="./Tie::Handle.html#DESTROY-this">#</a><a id="DESTROY"></a>DESTROY this</dt>
<dd>

<p>Free the storage associated with the tied handle referenced by <i>this</i>. This is rarely needed, as Perl manages its memory quite well. But the option exists, should a class wish to perform specific actions upon the destruction of an instance.</p>

</dd>
</dl>

<h1 id="MORE-INFORMATION"><a class="permalink" href="./Tie::Handle.html#MORE-INFORMATION">#</a><a id="MORE"></a>MORE INFORMATION</h1>

<p>The <a href="perltie.html">perltie</a> section contains an example of tying handles.</p>

<h1 id="COMPATIBILITY"><a class="permalink" href="./Tie::Handle.html#COMPATIBILITY">#</a>COMPATIBILITY</h1>

<p>This version of Tie::Handle is neither related to nor compatible with the Tie::Handle (3.0) module available on CPAN. It was due to an accident that two modules with the same name appeared. The namespace clash has been cleared in favor of this module that comes with the perl core in September 2000 and accordingly the version number has been bumped up to 4.0.</p>


      </div>
      <div id="footer">
        <p>Perldoc Browser is maintained by Dan Book (<a href="https://metacpan.org/author/DBOOK">DBOOK</a>). Please contact him via the <a href="https://github.com/Grinnz/perldoc-browser/issues">GitHub issue tracker</a> or <a href="mailto:dbook@cpan.org">email</a> regarding any issues with the site itself, search, or rendering of documentation.</p>

<p>The Perl documentation is maintained by the Perl 5 Porters in the development of Perl. Please contact them via the <a href="https://github.com/Perl/perl5/issues">Perl issue tracker</a>, the <a href="https://lists.perl.org/list/perl5-porters.html">mailing list</a>, or <a href="https://kiwiirc.com/client/irc.perl.org/p5p">IRC</a> to report any issues with the contents or format of the documentation.</p>


      </div>
    </div>
    <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.5.1/jquery.slim.min.js" integrity="sha512-/DXTXr6nQodMUiq+IUJYCt2PPOUjrHJ9wFrqpJ3XkgPNOZVfMok7cRw6CSxyCQxXn6ozlESsSh1/sMCTF1rL/g==" crossorigin="anonymous"></script>
    <script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.16.1/umd/popper.min.js" integrity="sha512-ubuT8Z88WxezgSqf3RLuNi5lmjstiJcyezx34yIU2gAHonIi27Na7atqzUZCOoY4CExaoFumzOsFQ2Ch+I/HCw==" crossorigin="anonymous"></script>
    <script src="https://stackpath.bootstrapcdn.com/bootstrap/4.5.2/js/bootstrap.min.js" integrity="sha384-B4gt1jrGC7Jh4AgTPSdUtOBvfO8shuf57BaghqFfPlYxofvL8/KUEfYiJOMMV+rV" crossorigin="anonymous"></script>
    <script src="../highlight.pack.js"></script>
    <script>hljs.highlightAll();</script>
  </body>
</html>
